home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / program / vbkontrol.exe / CSWSK10A.ZIP / readme.txt < prev    next >
Text File  |  1995-07-25  |  9KB  |  183 lines
  1.                         SocketWrench/VB Custom Control
  2.                                  Version 1.0a
  3.  
  4. Welcome
  5.  
  6. Please read this document carefully; it contains information about installing
  7. and using the SocketWrench Windows Sockets custom control. Before you install
  8. the control, please be sure that your system has the following products
  9. installed (the version number indicates the earliest release that is supported;
  10. a later release may also be used):
  11.  
  12.     Microsoft Windows 3.1 or Windows for Workgroups 3.11
  13.     Visual Basic 3.0
  14.     Windows Sockets 1.1 Library
  15.  
  16. If you have any questions about which version of the above products are
  17. installed, check the software documentation or contact your network or 
  18. systems administrator.
  19.  
  20. Catalyst Software
  21.  
  22. SocketWrench/VB is part of a larger package currently under development by
  23. Catalyst Software. In addition to the comprehensive, but fairly low-level,
  24. access that SocketWrench provides, our package will include libraries
  25. and custom controls for many of the popular Internet application protocols
  26. such as FTP, TELNET, SMTP, POP3 and HTTP. Both dynamic link libraries (DLL's)
  27. and custom controls for Visual Basic (VBX's) will be included, providing the
  28. greatest flexibility to developers. And, of course, there are never any
  29. royalties or other hidden costs with any of Catalyst's tools.
  30.  
  31. We feel that the most exciting component in the package is our World Wide
  32. Web browser custom control. The control offers the best of both worlds:
  33. a powerful browser that can be easily customized to meet the needs of your
  34. application. Although the Web control offers many options in the form of
  35. properties, methods and events, you can create your own custom browser by
  36. simply selecting the control, creating a text and button control and setting
  37. the resource property. And when integrated with our other controls, you can
  38. build a fully-featured, Internet-enabled application in just minutes!
  39.  
  40. Free Distribution
  41.  
  42. SocketWrench is freely re-distributable software. You may use the control
  43. in your own applications and redistribute the package as needed. However,
  44. SocketWrench has not been placed in the public domain. Catalyst Software
  45. retains the copyright and may, without prior notice, release subsequent
  46. versions of SocketWrench that are not freely re-distributable. As a developer,
  47. you may include the control in your applications as per the license agreement
  48. included with this software distribution.
  49.  
  50. If you have found SocketWrench to be useful, please consider registering the
  51. software by completing the form in the register.txt file. There is no charge
  52. or obligation when registering SocketWrench, and you'll receive a $50.00
  53. discount towards the purchase of the complete package when it's released.
  54. To contact Catalyst Software, write to:
  55.  
  56.     Catalyst Software
  57.     638 Lindero Canyon Road
  58.     Suite 107
  59.     Oak Park, California  91301
  60.  
  61.     Phone:    818.879.1144
  62.     Fax:    818.879.1211
  63.         Email:    mstefan@catsoft.com
  64.  
  65. Please include your full name, address, daytime voice and fax number, and
  66. your email address if available. Catalyst Software is committed to providing
  67. tools, utilities and component software that truly solve developers problems.
  68. You can help right now by simply letting us know who you are. Thank you for
  69. your support.
  70.  
  71. Documentation
  72.  
  73. The documentation for this control is provided both as a Windows help file
  74. and as a Microsoft Word 6.0 document. Although the document is copyrighted,
  75. it may be freely copied and redistributed throughout your organization as
  76. needed.
  77.  
  78. Installation
  79.  
  80. To install SocketWrench, run the installation utility that is included with
  81. the package. If the package was downloaded from a bulletin board system, it
  82. will be necessary to extract the files from an archive. To install the
  83. software, select File..Run from the Program Manager menu. A dialog box will
  84. prompt you for the name of the program to execute. If you are installing from
  85. a diskette, enter a:\setup. Otherwise, specify the complete path where the
  86. setup utility is located.
  87.  
  88. When the installation begins, you will be prompted to enter the name of a
  89. directory where documents and sample programs can be installed. If the
  90. directory does not exist, you can choose to have the setup utility create
  91. it for you. This distribution contains the following files: 
  92.  
  93.     cswsock.vbx    SocketWrench custom control
  94.     cswsock.hlp    Help file for the custom control
  95.     cswsock.bas    Visual Basic module to include in projects
  96.     cswsock.doc    SocketWrench control documentation (Word 6.0 format)
  97.     tcpintro.doc    Introduction to programming with SocketWrench
  98.     compat.wri    Control compatibility notes
  99.     license.wri    Software license agreement
  100.     generic.*    Visual Basic project for a sample application
  101.     tcpecho.*    Visual Basic project for a TCP test utility
  102.     udpecho.*    Visual Basic project for a UDP test utility
  103.     tinyftp.*    Visual Basic project for a simple FTP client
  104.  
  105. The SocketWrench control and help file will be copied to the \WINDOWS\SYSTEM
  106. directory along with the other Visual Basic controls. After all of the files
  107. have been installed, you will be prompted if you wish to create a program
  108. group for the help and documentation files.
  109.  
  110. Once the installation is completed, you can add the control to your project
  111. from within Visual Basic by selecting File..Add File from the menu. Select
  112. the cswsock.vbx file from the file list, and you should see the control added
  113. to your toolbox. It is suggested that you also include the cswsock.bas module
  114. in your project as well. It defines global constants that are commonly used
  115. when programming the control.
  116.  
  117. Windows Sockets Loopback Library
  118.  
  119. For those systems that are not connected to a network, or do not have
  120. a Windows Sockets library, a stub "loopback" library has been included
  121. with this distribution of SocketWrench. This library allows SocketWrench
  122. to function as though a network connection exists, which in turn allows
  123. you to develop applications with SocketWrench. This library should only
  124. be installed and configured by someone who is familiar with TCP/IP. It
  125. should never be installed on a system which already has another TCP/IP
  126. protocol stack installed.
  127.  
  128. If no Windows Sockets library is found on your system when SocketWrench
  129. is installed, you are given the option to install the loopback library.
  130. If you do install the library, it will be copied to the installation
  131. directory as WINSOCK.DLL. In order for the SocketWrench control to find
  132. the library, you must either include the installation directory in your
  133. PATH environment variable, or copy it to the \WINDOWS directory. If you
  134. do copy the library to the \WINDOWS directory, you must also copy the
  135. WINSOCK.INI file there as well. This file contains configuration data
  136. used by the library, and has two sections which look something like this:
  137.  
  138. [Host]
  139. Address=192.0.0.1
  140. Name=myhost
  141. Domain=mydomain.com
  142.  
  143. [Files]
  144. Hosts=c:\catalyst\winsock\hosts
  145. Protocols=c:\catalyst\winsock\protocol
  146. Services=c:\catalyst\winsock\services
  147.  
  148. The first section, "Host", describes the local system. The "Address"
  149. item specifies the IP address that is to be associated with the local
  150. host, "Name" specifies the name of the host, and "Domain" specifies
  151. the host's domain.
  152.  
  153. The second section, "Files", specifies the location of the text databases
  154. which are used by the loopback library. If the values are incorrect
  155. (such as if they specify non-existant files), the function calls associated
  156. with the item will fail. This means that if, for example, the protocol
  157. file does not exist, any function which attempts to resolve a protocol name
  158. will fail with an error.
  159.  
  160. Reporting Problems
  161.  
  162. If you encounter a problem, either with the control itself, or with the
  163. documentation, please document the error and send an e-mail message to either
  164. of these addresses:
  165.  
  166.     CompuServe:    72202,1427
  167.     Internet:    mstefan@catsoft.com
  168.  
  169. Please be as specific as you can about the problem that you're experiencing.
  170. When reporting the problem, please be sure to include the following
  171. information in your message:
  172.  
  173.     Operating system and version
  174.     Physical connection (Ethernet, dialup SLIP/PPP, etc.)
  175.     TCP/IP vendor and version information
  176.  
  177. Known problems with a specific vendor's Windows Sockets implementation can
  178. be found in the Compatibility Notes document distributed with this product.
  179.  
  180. Copyright 1995, Catalyst Software. All rights reserved.
  181. SocketWrench is a trademark of Catalyst Software.
  182. Windows and Visual Basic is a trademark of Microsoft Corporation
  183.